From 6e14b2662225a42aae5d83b7ca519a742efcfa5f Mon Sep 17 00:00:00 2001 From: =?utf8?q?Timm=20B=C3=A4der?= Date: Fri, 18 Sep 2020 18:41:01 +0200 Subject: [PATCH] gsk: Add docs for radial gradient nodes --- docs/reference/gsk/gsk4-sections.txt | 11 +++++++++ gsk/gskrendernodeimpl.c | 34 ++++++++++++++++++++++++++++ 2 files changed, 45 insertions(+) diff --git a/docs/reference/gsk/gsk4-sections.txt b/docs/reference/gsk/gsk4-sections.txt index efc24e070d..3d0e9f0ccf 100644 --- a/docs/reference/gsk/gsk4-sections.txt +++ b/docs/reference/gsk/gsk4-sections.txt @@ -37,9 +37,11 @@ GskCrossFadeNode GskDebugNode GskInsetShadowNode GskLinearGradientNode +GskRadialGradientNode GskOpacityNode GskOutsetShadowNode GskRepeatingLinearGradientNode +GskRepeatingRadialGradientNode GskRepeatNode GskRoundedClipNode GskShadowNode @@ -71,6 +73,15 @@ gsk_linear_gradient_node_peek_end gsk_linear_gradient_node_get_n_color_stops gsk_linear_gradient_node_peek_color_stops gsk_repeating_linear_gradient_node_new +gsk_radial_gradient_node_new +gsk_radial_gradient_node_get_n_color_stops +gsk_radial_gradient_node_peek_color_stops +gsk_radial_gradient_node_get_start +gsk_radial_gradient_node_get_end +gsk_radial_gradient_node_get_hradius +gsk_radial_gradient_node_get_vradius +gsk_radial_gradient_node_peek_center +gsk_repeating_radial_gradient_node_new gsk_border_node_new gsk_border_node_peek_outline gsk_border_node_peek_widths diff --git a/gsk/gskrendernodeimpl.c b/gsk/gskrendernodeimpl.c index 45734b5599..bc16f53980 100644 --- a/gsk/gskrendernodeimpl.c +++ b/gsk/gskrendernodeimpl.c @@ -490,6 +490,23 @@ gsk_radial_gradient_node_diff (GskRenderNode *node1, gsk_render_node_diff_impossible (node1, node2, region); } +/** + * gsk_radial_gradient_node_new: + * @bounds: the bounds of the node + * @center: the center of the gradient + * @hradius: the horizontal radius + * @vradius: the vertical radius + * @start: a percentage >= 0 that defines the start of the gradient around @center + * @end: a percentage >= 0 that defines the end of the gradient around @center + * @color_stops: (array length=n_color_stops): a pointer to an array of #GskColorStop defining the gradient + * @n_color_stops: the number of elements in @color_stops + * + * Creates a #GskRenderNode that draws a radial gradient. The radial gradient + * starts around @center. The size of the gradient is dictated by @hradius + * in horizontal orientation and by @vradius in vertial orientation. + * + * Returns: (transfer full) (type GskRadialGradientNode): A new #GskRenderNode + */ GskRenderNode * gsk_radial_gradient_node_new (const graphene_rect_t *bounds, const graphene_point_t *center, @@ -536,6 +553,23 @@ gsk_radial_gradient_node_new (const graphene_rect_t *bounds, return node; } +/** + * gsk_repeating_radial_gradient_node_new: + * @bounds: the bounds of the node + * @center: the center of the gradient + * @hradius: the horizontal radius + * @vradius: the vertical radius + * @start: a percentage >= 0 that defines the start of the gradient around @center + * @end: a percentage >= 0 that defines the end of the gradient around @center + * @color_stops: (array length=n_color_stops): a pointer to an array of #GskColorStop defining the gradient + * @n_color_stops: the number of elements in @color_stops + * + * Creates a #GskRenderNode that draws a repeating radial gradient. The radial gradient + * starts around @center. The size of the gradient is dictated by @hradius + * in horizontal orientation and by @vradius in vertial orientation. + * + * Returns: (transfer full) (type GskRepeatingRadialGradientNode): A new #GskRenderNode + */ GskRenderNode * gsk_repeating_radial_gradient_node_new (const graphene_rect_t *bounds, const graphene_point_t *center, -- 2.30.2